Auftrag contactINFO
Funktion
Der Auftrag dient dazu, die Daten eines Contacts abzufragen.
Voraussetzungen
Der Contact muss existieren.
Besonderheiten
Sie können nur Daten von eigene Contacts abfragen.
Auftragsparameter
Ein Auftrag enthält die nachfolgend beschriebenen Parameter:
| K/V-Schlüsselwort | XML-Namensraum und Element | Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung |
| Action | contact info | 1 | enumeration | Info-erule | Auftragstyp |
| Version | - | 1 | enumeration | version-erule | Version, nur für Aufträge im Key/Value-Format relevant. |
| Handle | contact:handle | 1 | token 9 - 32 |
contact-rule | Eindeutige ID des Contacts. Syntax: <RegAccId>-<ID vom Mitglied> |
Häufige Fehler
Das im Auftrag angegebene Contact-Handle existiert nicht
Datenobjekte PERSON und ORG
| K/V-Schlüsselwort | XML-Namensraum und Element |
Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung | Policy |
|---|---|---|---|---|---|---|
| Handle | contact:handle | 1 | token 9 - 32 | contact-rule |
Eindeutige ID des Contacts, Syntax: <RegAccId>-<ID vom Mitglied> |
Das Handle eines Contacts muss immer mit der eigenen RegAccId des verwaltenden RegAccs beginnen. |
| Type | contact:type | 1 | enumeration | role-erule | Typ
des Contacts:
|
|
| Name | contact:name | 1 | normalizedString 1 - 255 | name-rule | Name des Contacts | Der Name kann nach dem Anlegen nicht mehr geändert werden |
| Organisation | contact:organisation | 0 - * | normalizedString 1 - 255 | organisation-rule | Organisation, für die der Contact tätig ist |
|
| Address | contact:address | 1 - * | normalizedString 1 - 255 | address-rule | Straße und die Hausnummer des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
| PostalCode | contact:postalCode | 1 | token 1 - 20 | postalcode-rule | Postleitzahl der Anschrift des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
| City | contact:city | 1 | normalizedString 1 - 80 | city-rule | Wohnort des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
| CountryCode | contact:countryCode | 1 |
Enumeration 2 |
country-erule | Countrycode des Landes, in dem der Wohnort des Contacts liegt. |
|
| contact:email | 1 - * | normalizedString 3 - 255 |
email-rule (siehe RFC5322 - Internet Message Format) |
E-Mail-Adresse des Contacts | „email“ ist ein Pflichtfeld und muss bei Contact CREATE- und Contact UPDATE-Aufträgen für die Typen PERSON und ORG mindestens einmal angegeben werden. |
| K/V-Schlüsselwort | XML-Namensraum und Elemente | 1. Verschachtelung | 2. Verschachtelung | Vorkommen min - max pro Verifizierungsinformations-Block |
Typ / Länge | Wertebereich | Beschreibung |
|---|---|---|---|---|---|---|---|
|
[VerificationInformation] |
<verification:verificationInformation xmlns:verification="http://registry.denic.de/verification/5.0" xsi:type="verification:verificationInformationType"> <verification:verifiedClaims> <verification:verificationResult> <verification:verificationReference> <verification:verificationTimestamp> <verification:verificationEvidence> <verification:verificationMethod> </verification:verificationInformation> |
- |
- |
Einmal pro Verifikationsdatensatz |
- |
- |
Bei K/V: Kopfzeile, die dem Verifikationsdatensatz voran steht |
|
- |
- |
<verification:verifiedClaims> <verification:claim> </verification:verifiedClaims> |
- |
- |
- |
- |
- |
| VerifiedClaim | - |
- |
<verification:claim> ... <verification:claim> |
1 - 3 | normalizedString / feste Länge durch vordefinierte Werte |
claim-rule | "claims" sind Daten, die verifiziert wurden. Besonderheit bei E-Mail Der komplette Verifizierungsinformations-Block mit allen Schlüsselwörten bzw. XML-Elementen und Werten muss bei einer E-Mail-Prüfung angegeben werden, wenn das Ergebnis der Prüfung negativ war, also den Wert "failed" hat. Eine nachfolgendes Update mit dem positiven Wert "success" muss ebenfalls mitgeteilt werden. War bei der Prüfung von Anfang der Wert "success" vorhanden kann der Verifizierungsinformations-Block mitgeteilt werden. |
| VerificationResult | - |
<verification:verificationResult> ... </verification:verificationResult> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
result-rule | Mitteilung über das Ergebnis der Verifikation |
| VerificationReference | - |
<verification:verificationReference> ... /verification:verificationReference> |
- |
1 | normalizedString / Länge wird vom Mitglied festgelegt |
reference-rule | Der Inhalt ist ein Freitext für eine Referenz auf eine Auftragsnummer, Bestellnummer, Kundennummer etc. |
| VerificationTimestamp | - |
<verification:verificationTimestamp> ... </verification:verificationTimestamp> |
- |
1 | date-time | timestamp-rule | Zeitpunkt, zu dem die Verifikation durchgeführt wurde. |
| VerificationEvidence | - |
<verification:verificationEvidence> ... </verification:verificationEvidence> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
evidence-rule | Nachweis, der bei der Verifikation geprüft wurde (z.B. für den Wert "idcard", was dem Personalausweis entspricht) |
| VerificationMethod | - |
<verification:verificationMethod> ... </verification:verificationMethod> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
method-rule | Methode, mit der die Verifikation durchgeführt wurde (z.B. für den Wert "pvr", was der Nachweis über die Methode "Video-Identifikation" wäre |
| TrustFramework | - |
<verification:trustFramework> ... </verification:trustFramework> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
framework-rule | Framework, das zu Verifikation herangezogen wurde. Bisher gibt es nur den Wert "de_denic", ggfs. folgen später weitere. |
Datenobjekt REQUEST
| K/V-Schlüsselwort | XML-Namensraum und Element |
Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung | Policy |
|---|---|---|---|---|---|---|
| Handle | contact:handle | 1 | token 9 - 32 | contact-rule | Eindeutige ID des Contacts. Syntax: <RegAccId>-<ID vom Mitglied> | Das Handle eines Contacts muss immer mit der eigenen RegAccId des verwaltenden RegAccs beginnen. |
| Type | contact:type | 1 | enumeration | role-erule | REQUEST = eine E-Mail oder eine URL im URI-Template-Format. | Für General Request und Abuse Contact darf Type nur REQUEST sein. |
| URI-Template | contact:uri-template | 1 |
normalizedString 8 - 1024 |
Aufbau siehe gemäß RFC 6570 - URI Template | Die Variablen "Ulabel" und "Alabel" im URI-Template werden bei Domainabfrage (Web-whois) mit der Domain ersetzt. | Der Inhalt des URI-Templates wird bei einem CREATE-Auftrag als Test in eine URL oder E-Mail umgewandelt (Für "Alabel" und "Ulabel" wird eine Beispieldomain verwendet.) um die syntaktische Korrektheit zu überprüfen. |
Beispiele
- xml
- k/v
format: xml
request: contactINFO
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:contact="http://registry.denic.de/contact/5.0" xmlns:verification="http://registry.denic.de/verification/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<contact:info>
<contact:handle>DENIC-1000022-EXAMPLE-XML-PERSON</contact:handle>
</contact:info>
</registry-request>
format: xml
response: contactINFO
<?xml version="1.0" encoding="UTF-8"?>
<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
<tr:transaction>
<tr:stid>b61d054e-d751-4c96-a180-c2eb4230a374</tr:stid>
<tr:result>success</tr:result>
<tr:data>
<contact:infoData xmlns:contact="http://registry.denic.de/contact/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<contact:handle>DENIC-1000022-EXAMPLE-XML-PERSON</contact:handle>
<contact:type>PERSON</contact:type>
<contact:name>John Doe</contact:name>
<contact:organisation>DENIC eG</contact:organisation>
<contact:postal>
<contact:address>Theodor-Stern-Kai 1</contact:address>
<contact:postalCode>60596</contact:postalCode>
<contact:city>Frankfurt am Main</contact:city>
<contact:countryCode>DE</contact:countryCode>
</contact:postal>
<contact:email>john.doe@denic.de</contact:email>
<contact:phone>+49.69272350</contact:phone>
<contact:changed>2024-09-27T16:40:53+02:00</contact:changed>
<verification:verificationInformation xmlns:verification="http://registry.denic.de/verification/5.0" xsi:type="verification:verificationInformationType">
<verification:verifiedClaims>
<verification:claim>address</verification:claim>
<verification:claim>name</verification:claim>
</verification:verifiedClaims>
<verification:verificationResult>success</verification:verificationResult>
<verification:verificationReference>ABC123/45GHT</verification:verificationReference>
<verification:verificationTimestamp>2023-11-11T14:36:21+01:00</verification:verificationTimestamp>
<verification:verificationEvidence>idcard</verification:verificationEvidence>
<verification:verificationMethod>auth</verification:verificationMethod>
<verification:trustFramework>de_denic</verification:trustFramework>
</verification:verificationInformation>
</contact:infoData>
</tr:data>
</tr:transaction>
</registry-response>
format: k/v
request: contactINFO
Version: 5.0
Action: INFO
Handle: DENIC-1000022-EXAMPLE-PERSON
format: k/v
response: contactINFO
type: PERSON
RESULT: success
STID: 8e9ccb16-f362-4eb3-9428-763bae69705b
Handle: DENIC-1000022-EXAMPLE-PERSON
Type: PERSON
Organisation: DENIC eG
Name: Max Mustermann
Address: Business Services
Address: Theodor-Stern-Kai 1
Address: in Frankfurt
Address: south side
Address: riverside
PostalCode: 60596
City: Frankfurt am Main
CountryCode: DE
eMail: email-1@denic.de
eMail: email-2@denic.de
eMail: email-3@denic.de
eMail: email-4@denic.de
eMail: email-5@denic.de
eMail: email-6@denic.de
Phone: +49.6927235x290
Changed: 2024-09-27T16:38:17+02:00
[VerificationInformation]
VerifiedClaim: name
VerifiedClaim: address
VerificationResult: success
VerificationReference: ABC123/45GHT
VerificationTimestamp: 2023-11-11T15:36:21+02:00
VerificationEvidence: idcard
VerificationMethod: auth
TrustFramework: de_denic
[VerificationInformation]
VerifiedClaim: email
VerificationResult: failed
VerificationReference: 354546TZQ
VerificationTimestamp: 2023-10-04T12:22:19+02:00
VerificationEvidence: email_ver_transaction_log
VerificationMethod: reachability
TrustFramework: de_denic